home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
RELIGION
/
BVD404.ARJ
/
BIBLEV.DOC
< prev
next >
Wrap
Text File
|
1992-06-16
|
13KB
|
307 lines
/--------------------------------------------------------\
| BIBLEV.DOC - Documentation for BIBLEV.EXE Version 4.04 |
| (C)opyright 1992 MorriSoft |
\--------------------------------------------------------/
PURPOSE
-------
BIBLEV is a program that will display a BIBLE Verse on your IBM PC or
other MS-DOS compatible computer, utilizing a variety of user
configurable output options.
REQUIRED FILES
--------------
BIBLEV.EXE - The main program file.
BIBLEV.DAY - The verse file.
BIBLEV.CFG - The configuration file used to store your color
preferences, font choices, etc.
VGA16.BGI - Graphics device driver used for SVGA, VGA and EGA
graphics modes. CGA, Hercules, and Text mode support
are built into the program file.
BIBLEV.DOC - This documentation file.
REVISION.DOC - File listing changes to BIBLEV from previous versions.
Look here to find what's new.
REGISTER.DOC - Registration form for BIBLEV.
RUNNING BIBLEV.EXE
------------------
The program can be run from the command prompt by typing "BIBLEV", or
can easily be added to a batch file. BIBLEV must either be in the
current directory, or in a directory specified as part of the DOS
path.
In a batch file, such as the AUTOEXEC.BAT file, you could run BIBLEV
in the following fashion. This example assumes that you have copied
all of the files for BIBLEV into a directory called "C:\BIBLEV", but
any directory can be used.
For example:
.
.
PATH = C:\;C:\DOS;C:\BIBLEV;C:\UTILITY
BIBLEV
.
.
1
By setting the DOS path to include the directory containing the
program, BIBLEV can now be run from any directory on your hard disk.
Note that BIBLEV will search all directories in the DOS path for its
data files. Therefore, for fastest performance, if you use a long
PATH statement, try to place the directory containing BIBLEV towards
the beginning of the PATH.
NOTE: If you are replacing an older version of BIBLEV (any version
prior to 3.00), you will need to delete the old 'BIBLEV.COM'
program file before you can use the new program.
USER SELECTABLE OPTIONS
-----------------------
Two user selectable modes of operation:
--------------------------------------
"Daily Verse" mode
------------------
When in this mode, BIBLEV will use the DOS date on your PC to
determine the verse to use, and then will print that verse from
the BIBLEV.DAY verse file. The verse will be the same each time
run that day. After using all of the verses in BIBLEV.DAY, the
program will start over again.
"Random Verse" mode
-------------------
In random mode BIBLEV.EXE will randomly select one of the tagged
verses in the verse file. Since it is entirely random, and not
based on date, the verse will be different each time run, even on
the same day.
User selectable time-out value:
------------------------------
After displaying a verse, BIBLEV normally waits for a key to be
pressed before exiting. Also, if a verse is longer than one screen, a
"MORE" prompt is displayed, and the program waits for the user to
press a key. The user can specify the number of minutes and seconds
to wait for a keypress, or even specify that BIBLEV wait forever.
This option is useful if you use BIBLEV in your AUTOEXEC.BAT file, and
want the computer to be able to boot up without you being there to
press a key.
2
Three different user selectable output modes:
--------------------------------------------
Standard Text (BIOS) output:
---------------------------
This mode of output uses the standard BIOS routines built into
your computer to perform text screen output. The colors in
effect at the DOS prompt when BIBLEV is invoked will be used.
This output mode should be used if you are redirecting the output
of BIBLEV to a file or printer. Also use this mode if you are
using a "screen reader" program of some type, such as those used
by vision impaired members of the computing community. For use
in this mode of operation is the command line parameter "N" (No
Title), which will suppress the program title and copyright
display. Also available is the "D" (Don't Wait) option, which
will suppress the "More" and "Press any key" prompts.
Color Text (Direct Video) output:
--------------------------------
This mode of output requires 100% IBM compatible video hardware,
and utilizes direct video writes to provide color text screen
output. This mode is available for Monochrome displays, but will
only provide black and white output. The primary users of this
mode will probably by the owners of CGA displays and adapters.
Owners of higher resolution Super VGA, VGA, EGA and Hercules
display adapters will probably want to use the Graphics output
mode.
Graphics output:
---------------
BIBLEV provides an optional graphics-based interface! If you
select this option, you will be provided with a menu of nine
attractive vector screen fonts, with user configurable size and
color. An on-screen menu and sample output assist you in making
a selection. Support is provided for Super VGA, VGA, EGA,
Hercules MGA, and CGA display adapters. With the exception of
Super VGA, the display type is automatically detected by BIBLEV.
If you do not desire to use this feature, simply choose one of
the text mode display options when in the configuration menus.
NOTE: The graphics mode fonts were designed for optimum
appearance on a high resolution video display. Some
fonts may be unreadable on a CGA adapter. Due to the
limited pixels on a CGA display, the parameter "N" can
be used to suppress Title and Copyright Display.
3
RUNNING SETUP
-------------
To configure BIBLEV.EXE, run with the command line option "S". I.e.,
C> BIBLEV S
This will invoke BIBLEV in the 'Setup' mode. You will first be asked
for the mode of operation. After selecting the 'Daily' or 'Random'
mode, you will then be asked to enter a time-out value in minutes and
seconds. Enter the length of time that you would like BIBLEV to wait
for a key to be pressed, or enter '0:0' to wait forever. Next, choose
the display output mode: 'Standard Text', 'Color Text' or 'Graphics'.
If 'Standard Text' is chosen, you are done with setup. Choosing
'Color Text' brings up a screen that allows you to set the colors you
prefer in text mode. If 'Graphics' mode is chosen, you will be given
a choice of ten fonts or typestyles, as well as a the ability to
change the size of the displayed characters. After making a
selection, you will then be given a choice of foreground and
background colors.
The program will then count the number of tagged verses in the verse
file, and write this information to the BIBLEV.CFG file.
ADDING OR CHANGING VERSES
-------------------------
All verses are contained in the file BIBLEV.DAY (for BIBLE Verse of
the Day). This file is simply an ASCII text file, and can be edited
with any ASCII text editor (almost any text editor or word processor
for the PC can edit ASCII files). Just make sure that you save the
file again in ASCII format - if in some other strange format, BIBLEV
will NOT work properly!
Each verse in the file MUST be marked, or tagged, with an asterisk (*)
if you want it to be used by BIBLEV. The file is very freeform, and
has no strict format. Verses can be as long as you desire, as BIBLEV
will pause when a verse is longer than one screen. I would recommend
not setting the margins wider than 80 if you are using text mode. If
you are using graphics mode, automatic word-wrap has been implemented,
so margins won't matter as much.
BIBLEV now automatic detects changes in the size of the Verse file!
After adding new verses, or deleting old verses, the next time BIBLEV
is run, it will go into an automatic setup mode to count the number of
verses in the verse file. The program will then proceed to run
normally.
4
COMMAND LINE PARAMETERS
-----------------------
S - <Setup> Starts BIBLEV in Setup mode.
N - <No Title> Runs BIBLEV in normal mode, and suppresses the
display of Title and Copyright notices. Only valid if
configured for Standard Text output or if running Graphics
mode on a CGA display.
D - <Don't Wait> Runs BIBLEV in normal mode, and suppresses the
"More" and "Press any key" messages, and ignores the timeout
setting. The program exits immediately, without pausing.
This option is only available in Standard (BIOS) Text mode,
and is intended primarily for use when redirecting output to
a DOS file or printer.
ND - Combine the "Don't Wait" and "No Title" options.
TECHNICAL SUPPORT
-----------------
Questions, comments and suggestions concerning BIBLEV can be sent to
GEnie address JMORRIS or CompuServe address 73670,762. If you do not
have access to either of these two services, write to:
MorriSoft
206 Attleboro Court
Meridianville, AL 35759-2244
REMARKS
-------
BIBLEV and its associated programs are written in C++, and compiled
with Borland's Turbo C++ Compiler.
BIBLEV and all associated programs and data files are provided 'as is'
with no expressed warranty of any kind. MorriSoft is in no way liable
for any damages, real or imagined, received thereof.
P.S.
----
Lastly, ENJOY! I hope many people find this program of some use, and
that it helps you grow in the Word even while using your computer!
5